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IMPORTANT NOTES 

unies= noted otnerwise. all numeric parameters should or 

tvoe INTEGER. It aooears that Basic will do this 

automatically tor parameters being oassed to. the BGFX 

subroutine.,' However- it is critical that parameter 

variables in whicn a value is expected to be returned legs 

WINfo) shou'Id be INTEGER typed. 



THE FUTURE 

As much, as dossidIs* BGFX should make it easy (and has) ig 
port manv CoCo3 applications to 0S9/6SK. However, because 
it's not totally compatible (eg: the Palette function),. I 
believe that a version called GFX2 will be done soon. 

Additional Basic libraries in the works includes 

BSND - allows loading, recording, plaving sound files 

BGUI -• interfaces to the cominq menus .^nd controls 

BIFF - easv IFF file format load and save interface 



-lANKS 



Liorarv : 



:nasma 



■his; r n n ■ 



the BGh X Inter- 



It vou tiav^ anv ideas for additions or hav^ found anv bugs- 
olease feel trsB to aroo me a line* I can be contacted most 
easily via email" 

CompuServe " 76703 « 422 7 

I n ternet : 76703 - 4227'^comDuserve. com 
k d a r 1 1 n q & c a tt.ncsu.ed u 



Updates will be made available to everyone who writes me at 

Kevin Darling 

3000" 79 3 ton vb rook Dr 

Raleigh, NC 27604 



Again, tnank you verv much. 
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Windowing 

DWSet 

DWEnd 

DWSet 

OWEnd 

Select 

C'wArea 

W I n t q 

Get / Put Bu-Fters 

GCSet 
GPLoad 

Get 
Put 
■ : ,x 1 IBuT-f 

Colors, Logic, Pattern 
Color 

Ge tP sis 
' :;: :V. ; ?rn 
Dra win a Commands 



ir* a r 
Box 



fc. 1 J. i d s e 

F i I 1 

F C .1 r c i a 

FElhDse 

SetPn t 

L i n e 

Poi n t 

RBar 

PBoj< 

SBom 

bcaleSw 

RSetDptr 

SetDPtr 
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Text Terminal i-unctions 

ANSI 

Clear 

Cursor Commands 

Erase C o m m a n d s 

Others 

Font Features 

BoIdSw 

}~ on t 

ProoSw 

TChrbw 

RevOn 
RsvC't-f 

UnaLnDn 
LindLnOtt 

Mouse and Keyboard 



GnKev 
On house 

Miscellaneous Commands 



hiscel laneous Information 

Stat Calls 
Revisions 
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FUNCTION 

Arc: - Draw an arc iDDrtion or ellipse) 
CODE 

IB 52 Xr xr Vr vr Xoi ;<oi Vol vol Xo2 xo2 V'o2 vo2 
BSFX 

RUN batx ( "Arc'' « xr , vr ,, xol « yoi - mq2, yo2 ) 
PARAMETERS 

xr. yr - the x and y radii of the basic ellipse 

>;oi,vci - offsets to trie start of a bisecting line 
;;Cj2„vc2 - o + TBets to the enaDoint or' a Disecting line 

DESCRIPTION 

Draw an arc, made lid or tne visible section of an 
ellipse as determined dv a bisecting line (the last 



i-or ex amp ie n to snow the lid per rignt Quarter or a bU)--4u 
ellipse centered at 320,100 (middle of screen), you 

could Li s e ;; 

RUN bn f x i :I arc u „ 320 „ 1 00 * SO „ 40 , , -40 « 60 „ ) 

XI, VI The line from Xi/Y'i to X2.Y2 chops 

!-.- off all but the uooer right ntAarte? 

YR ! . . . . „ 

I XR YR = 40 X2,Y2 = 80.0 

! + = origin - 320.100 

The bisecting line coords are offsets from th& ellipse 
O'-j'v' », I-f you reverse its si one dv swapping XI, VI and 
X2-Y2. then all BUT the tipper right Quarter would be 
seen . 

Notes The bisecting line coords simply give the 
slope.,. they don't actually hav^ to mark out the a 
line which crosses the basic ellipse... but instead a 
line drawn through the two points. In other words, 
take any ellipse which would be drawn of XRVYR shape, 
and then draw a line through any (offset from ellipse 
origin) XI ? Y1~X2„ Y2 point pair- 

SEE ALSO 

S e- 1 DP t r ■ R Se t DP t r 



BAR GSK. BGKX Library BAR 

FUNCTION 

Bar. RBar, - Draw a bar (tilled rectangle) 

CODE 

IB 4A X2 x2 V2 v2 (absolute) 
IB 4B Xo xo "y'o Yd (relative) 

BGFX 

RUN bgfx ( [path. J "Bar". x2« v2) 

RUN bg f x (Coat h , 3 " Ba r Ji , x 1 , y I , x2 , y 2 ) 
RUN bgfx (Loath,] "RBar\xo, yoJ 

PARAMETERS 

x i , ■/ 1 - o o t i on a 1 t i r s t move-to c do r d i n a t es 

x2,v2 - end coordinates 

xo,ya -■ end ottsets from current draw pointer 

DESCRIPTION 

Bath -functions draw a -filled rectangle beginning at tne 
draw do inter's currBnt position- using tne current 
•foreground color, logic and pattern- 

Bar draws a &&r ending at coordinates x2 , v2 ■ 

RBar draws a bs.r to tne relative of f set coordinates 

SEE ALSO 

5 e t DP tr, R S e t DP t r 



9ELl- u:;!\ BSFa Liorarv BELL 

FUNCTION 

CODE 

i - ■* / 
BGFX 

RUN DQfxitpathJ "Bsii") 

DESCRIPTION 

On the MM/I, this current Iv rings tne simple 
timer-based bell (usually attached to the small speaker- 
inside your case)- 



b E 2. 1 E '?< u 5 K t> b t- X L i. D r a r v & E i I E R 

FUNCTION 

Bezisr - draw a bezier curve 
CODE 

IB 55 XI k I Yiyi X2k2 Y2v2 X3x3 Y3y3 X4;<4 Y4y4 
B6FX 

RUN bgt:<( "Bezier" - ;< 1 , yl , x2 , y2 „ x3 . v3 , x4,y4) 

PARAMETERS 

xi,yi ~ start ocint 

x2,y2 ~ second control point 

x3,y3 - third contra I point 

;■:"■! ., v4 - end point 

DESCRIPTION 

Dr&ws a -four — point bezier line* from o;i a yi ) to 

i;-:4,v4) , curvea bv tne two middle control points- 

CAVEATS 

Mote tnat the coordinates are aDsoiuts., I hope to bgci 
.■3 relative c o o ^ n i ~ ; a t e '■■/ o r b i o n ™dqp , wm c n s n o u I d o £? 



EXAMPLE 



See trie "testbez" orooram in vour DEMC 



Ki • y 1 ;<4 - v4 



x3,y3 x2,y2 
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FUNCTION 

Bo>; H RBox, - Draw a box (rectangle) 

CODE 

IB 48 X2 x2 V2 v2 (absolute) 

l p 4 9 v ,-,- ^ q y q y q ( ppi ,3 r i v e ) 



BBFX 



RUN oq-f x ( L" Darn,, 3 "Box", x2„ v2) 

RUIN Dgtx C [oath, J :; Box% xi. vi, x2, v2 > 

RUN bat x ( II path „ 1 "RBox " „ xo ,. yo) 



PARAMETERS 



i ~ ootional first move- to coordinate 

2 ~~ end coordinates 

-•: — pj ;-j j~3 r'! i~ -f ~. £•• "r ~ -j- f-™ c; m c u rrsn t d r a w d o i 



DESCRIPTION 



Jt;ot r ' -functions draw a rectanais neginninq at the arai* 
pointer's current position* 

B o x d r a w s a b o x e n d 1 n o a t c o o r d i n a t e s x 2 « v 2 . 



SEE ALSO 

P, ;T-i 1- ! "s }-' 1" r" i( }"■' P, p f", p' J T f-~ 



l, h u .- :: . u 'r, ;■ . r : ld r X LiDrarv 

FUNCTION 

CBox . RCBox « - Dra^ a ddx with curved corners 
CODE 



I Jb 4L X^: ;;^ Y^ V2 

IB 4D Xd- mo Yo y"o 



, r ;<r vr vr 
, r v-.r Y r v r 



< aosolute > 
( relative ) 



bbFX 



RUN bat>;(LDathJ "CBox" , m2, v2) 

RUN bgfM(Loath„J "CBoj-;", Mi, yi, x2„ v2 ) 



PARAMETERS 



;-i,:Vi ~ DDtional first move-to coordinates 

x 2 * v 2 ~ E?nti coorGinatss 

xr^sr - radii of curved corners 



DESCRIPTION 



or aw a rectangle wi - 
see depicted as but" 



urved corners (such as you m: 
on some comouters). 



Ubo>; draws a box enamq at coordinates x2,v2u 

CRBom araws a line to the relative offset cooram; 






UAVEATb 

Because of screen asoects, you usually want to make 
X radius about twice that of the Y radius. 

SEE ALSO 

SstDPtr, RSetDPtr, Box 



:he 



03K BGFX Library CIRCLE 



FUNCTION 



CODE 



BGFX 



Lircie — iraw a circle 
FCircle ~ Draw a tilled circle 



IB 50 r t i normal ) 

IB 53 r r ( f i I led ; 



RUN hgfx ( Loath, 1 "Circle". >; , v, r) 

RUN bg-f* C Cpath, 3 "Circle", r) 

RUN bat>;([Dath,3 "FCirciB" . >; , y, r) 

RUN bgf ;< ul path , J "FCircle 1 ', r) 



PARAMETER! 



= optional first move-tc coordinate 
= radius 



DESCRIPTION 



Draws a circle centered on the passed coordinates or 
the current draw Domter. A filled circle will use the 

c u r rent o attern, I og ia and colors inside. 

CAVEATS 

Ii a coordinate is passed,, the draw pointer is updated to i 
SEE ALSO 

SetDPtr , RSetDPtr 



db!- X Liorsrv 



CLEAR 



FUNCTION 

Clear - ci&ar a window 
CODE 

OC 
BGFX 

RUN bqf k ( Coath H li "Clear; 
DESCRIPTION 



:ns c u rrsnt w o r k i n o a r s? ■: 



a window to the 



jac k a round co I at 



SEE ALSO 



U 3 lor, C w A r e? a 



■-■ J i™ u \~\ u -a r-. b d r X Lid r a r v C Li L R 

FUNCTION 

Set Text/Drawing Colors to soecitiaci oalstts register 

CODES 

FColor - IB 32 prn 

BCoIor - IB Z'5 prn 

Border - IB 34 prn 



BGFX 



RUN baf x ( Coath. 3 "Color 11 . fore_prn C , back ...prn J C „ border_prn J ) 
RUN baf x i [path, 1 "Border" , Dorder prn ) 



PARAMETERS 



oath ~ optional GS-9 patn number for the window 
forewarn ~- oalette register number for foreground drawing 
back__prn = optional reaister number for oackqrouna 
boraer orn ™ oDrior.al register numoer for screen Doraer 

DESCRIPTION 

Color rnanoBS the foreground '.and optionally,, 

background and boraer, 1 colors for a window. host 
Graphics use onlv tne foreground color. Text uses oath 
fore/ background un i ess in trans Daren z mode . 

SEE ALSO 

P a 1 e 1 1 e « Clear 



CuFvBOR CMDS OSr, BGFX Library CURSuK CMDS 

CURSOR COMMANDS 

CurHome - move cursor to col ana row 

CurLft ™ move cursor back one position 

CurRgt - move cursor right one position 

CurtJo - move cursor up one row 

CurDwn - move CLtr^cr down one row 

CrRtn - send carriage return 

CurXY "- position cLirsor 

CurOn - turn text cursor on 

Cur Off - turn text cursor off 

BGFX 

RUN bqf x < L'path if 1 "CLirXY" ,coI, row) 

RUN bgf x < C oath . J "CurHome" ) 

RUN bgf x ( iloath. II "CurLft" ) 

RUN bgf x ( II path * II "CurRgt" ) 

RUN bgf x ( loath , 1 "CurUp" ) 

RUN bgfx( [path, 3 "CurDwn" ) 

RUN bgf x ( [oath, J "CrRtn ;i ) 

RUN ogf x ( L oa tn „ 3 "Cur On " > 

RUN dgf x ( ilDatn,, II "Curuf f " ) 

PARAMETERS 

col,, row = for aosolLite cursor positioning 

coiurnn an '3 row dscji~ at ZERU v n * 

DESCRIPTION 

These commands allow manipulation or the text cursor,: 

CAVEATS 

These are Window specific caii^ arid mav net work 
properly on a remote dumb terminal . 

SEE ALSO 

Clear. CWArea, and Erase functions 



CwrREA 05- B[jFX i^^hrar^ CwArcEA 

FUNCTION 

CwArea - Change winaow working area 
CODE 

lB 25 cd;-; coy bzx szv 
BGFX 

RUN pg f y, (Lpatn., ] " C wA r ea ",cp x * c oy ,s:x,s: v ) 

PARAMETERS 

Dath = optional GS-9 path number for the window 
cox = Horizontal character position tor the upper 

left corner of the working area 
c pv = ver t i c a 1 p o snion for t he u p d e r left c o rn e r 

of the wcrKing ar^a 
5Z>; = size (width.' of the working area in cnaracters 
szv ~ size (neignc^ of the working area in characters 

DESCRIPTION 

CWAREA cnanges the working area oi a window to the new 
location given bv cox ., coy , wmch is an o^fs&r from ine 
oosition of the oricmal window area. The size is 



"i e ;■*: t a n d ci r a p h a. c s o u t o u t w i 11 be confined t o t n i ~ a r e a 
until changed. If scaling is turned out. graonics 
o u t d u t w i 1 1 oes c a led down- 



CAVEATS 



T h i s c a II c an n o t ma k e a w i n d ow larger than o r i g i n a 1 I ■ 
defined. It can only change the working ar&a insici 
the? window- 



i. 1 £. !"■ L, \J L U o r. t: ; Ls r A L. X D '"" =1 r V U E. !"' L, U L. 

FUNCTION 

DefCol - Reset ail oalettes to default colors 
CODE 

IB 30 
BGFX 

RUN hafx ( [path, J "DefCol" ) 
PARAMETERS 

oath ~ optional OS-9 oath number tor the window 

DESCRIPTION 

DefCol resets the colors associated with the window 
specified bv oath to the default (Startup/ colors. 

CAVEATS 

DefCol will restore any changes which have occurred to 
the palettes on the specified window since oootuo, 

SEE ALSO 

P alette 



DwSET uSK jyGFX Library DWSET 

FUNCTION 

DWSet - Device window Set 
CODE 

IB 20 sty epx coy szx szy fprn prn 
BGFX 

RUN hgf x ( [oath, J "DWSet" , sty «cp;-; , cpy , sz x , szy H fprn", bprn ) 

PARAMETERS 

patn — OS- 9 path number -for the window 

s t y — window t v p e 

cdx — horizontal cnaractsr position -for tne upper 

left corner of the window 
cpy - vertical oosition for the uoper left corner 

of the window 
szx = size (width) of the window in cnaraeters 
szy = size (height) of tns window in characters 
f nrn -- foreground palette register number 
born = background palette register number 

DESCRIPTION 

Creates a device in a window of type sty. If stv=ff 



r n b *.- v s t . e fti o d e n s the winoow on tns currsnt Ec r 3sn r 

The winaow has its upper left corner ioa^tBa at cox , c py 
„ and its size set to szx . szv , Note that the 

(8x8) coordinates* 

The window uses fprn. as the foreground palette and .bprn 
as tne bacKaround palette. 



( c o n 1 1 n u e d o n n e x t p a a e ) 
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"ne -^ol lowing list Describes tne supported screen tvnes: 

Type 

non-interlaced 

interlaced repeat 

interlaced 

non-interlaced 

interlaced rso^a. t 

interlaced 

non-inter 1 aces overscan 

i n t e r 1 aced o ve r sc an 

overscan 

interlaced overscan 



Code 


Cha 


r 5 i z 


e 


F' i ;■( e I 


s Size 


Colors 





80 


x 26 




640 


v 


208 


16 


01 


SO 


x 2 6 




640 


x 


416 


16 


02 


80 


X D 2 




640 


X 


416 


16 


03 


40 


;' 2 6 




320 


>< 


20 S 


256 


04 


40 


X ji. & 




320 


x 


416 


',-;_' ^J £j 


05 


40 ' 


■■c ^ 2 




320 


x 


416 


ll O (Z 1 


6 


90 


x 3 




720 


X 


240 


16 


O 7" 


90 


;•' 6 




720 


X 


240 


16 


OS 


4S 


>■ 30 




384 


x 


240 


256 


9 


48 


x 6 * j 




284 


x 


480 


256 


FF 


Cur 


ren 1 1 


v 


D i s p 1 


a 


yed Scr 


een 


FE 


Cur 


r<sn t 1 


v 


Selec 


4- 


ed Screen 



CAVEATS 



j h e s e m o d e s ars> the modes t o r t n e hi i v ! / 1 a n d m a y n o t b e 
s u DDorte d o n o t n e r h a r d w a r e « 



DwEND 08k iriGKX Library DwLND 

FUNCTION 

DwEnd - Device wihgqw End 
CODE 

IB 24 
BGFX 

RUN hqf x < Loath* 3 "DWEna" > 

DESCRIPTION 

Closes the device window associated with the soecified 
oath. If the closed window is the iasi device window 
on the screen, DWEND deallocates the screen « 

CAVEATS 

Tnis call is not necessary if tne device was not 
ini: ; a „ as tne internal device termination will 
automatically call the DWEnd function » 

SEE ALSO 

DwSet k ) 



£ l. l.. I F 1 b E U 8 K b'GFX L .1 ::> rarv E L. L. IPSE 



FUNCTION 



CODE 



BGFX 



iiiUDse - uraw an euinse 
FEliioss ~ Draw =t tilled ellinse 



IB 51 r>r rK rv rv (normal) 

1 B 54 ry, ' rx rv rv ( t i 1 I ed > 



RUM baf ;' ( l oath , j "Ell lose' 1 - x, v„ y.r „ vr) 
RUN DgtxupatnJ "Ellipse", xr, vr) 

RUN DCtK(LDath„] "FE1 liose" - x, v, ;<r„ yr) 

1! . kt, vr ) 



PARAMETERS 



;•-. .. v -= QDticnai first move-to coordinate 
rx.rv = x ana v radius 

DESCRIPTION 

Draws an elliose centered on tne passed coordinates or 
tne current ar.BMt pointer. A filled elliose will use 
tne current oat tern. logic and colors inside, 

CAVEATS 

l J - a coordinate is Gassed « the draw cointer is uodated to it 
SEE ALSO 

SetDPtr „ RSetDPtr 



FIi_L QSK B6FX Library i-ILL. 

FUNCTION 

Fill - Flood Fill Area 
CODE 

IB 4F 
BSFX 

RUN bgtxC Loath. 3 "Fi 1 i " C * x „ vH ) 
PARAMETERS 

x*v = optional first move-to position 

DESCRIPTION 

Sets the pixels surrounaing the current draw do inter to 
the foreground color. The Fill ©Deration continues 
outward until it rsacrias either the edge of the screen 
or pixels that are a color other than the oixel at the 
draw oointer's current Dosition» 

CAVEATS 

The current version of WinrilO uses a smoother (but 
slower) fill method if no pattern is in use- The 
.Method used with a pattern can aet ''stuck' 1 < qbc^u.^^ it 
tries to go back over the same holes left by the 
pattern) and mav be delaved m returnina. I'm working 

J" ;}-) 1 t" „ 

SEE ALSO 

SetDPtr, RSetDPtr, Point. GetPnt 



^uhf'T GSK BGFX Liorarv FONT 

FUNCTION 

Font - Select/Chanae the tont used -for Text. 
CODE 

IB 3 A grp bin 
BGFX 

RUN bat x ( C oath, 1 "Font", gro, btn) 
PARAMETERS 

path = optional path number tor the window 
gro = group associated with the bu.irs i r 

Dtn = butter number 

DESCRIPTION 

Font specitj.es the Get/Put buffer to use for text- Tdb 
font must De loaded into tne Duffer usino GPLoad . 

h font Duffer is normal. Iv composed of on/off data Pits- 
ana, toy- now, must be 3 pixels wide- 

At this time,, grouos $80 and $S1 ars- reserved for 

vector fonts ana Amiga fonts- 

To return to tne a&^&uit font in the std fonts module „ 
use s. crou.D ana buffer numDer of zero. 

SEE ALSO 



bi-Loaa 



L-iucsfcL f GSK BGFX Librarv GCSET 

FUNCTION 

GCSet - Set ou.ffer to use for graphics cursor 
CODE 

IB 39 arp hfn 
BGFX 

RUN bgf x ( Cpath„ 3 "GCSet", grp, b-fn) 

PARAMETERS 

g r d z ~ b u f ter or d li id 

btn = buffer rmm&er within group 

DESCRIPTION 

Sets the source DLifrer for ine graphics cursor in a 
window wnen it is tne current. in out device. 

To revert to the cefaLiit DLiiIt— m arrow cursor. simoly 
GCSet to groLio -and nixi-i^r nLurioer zero,, 

provided in tne stdotrs files (group $CA). 
CAVEATS 

ma ten the screen tvpe o-'r tne destination window „ 
SEE ALSO 



u r ' L o a d 



•iE"! CJSK BGFa Library GET 

FUNCTION 

bs?t - Save an area o+ the screen to a Get/Put butter. 
CODE 

IB 2C arp bfn xh xl vh yl xsizeh xsizel vsizen ysizel 
BGFX 

RUN Dgf x ( [path, 3 "Get " . gro „ bfn , x , y „ xsize , ysize ) 

PARAMETERS 

Datn = ootional 0S-? oath number tor the window 

gro = arouo number associated with the butter 

btn ™ Duffer n Limber 

x = starting Horizontal screen position 

- starting vertical screen position 

xsize " Horizontal number of oixeis to get 

vsize ~ vertical pumper ot oixeis to get 

DESCRIPTION 

Copies a block: ot screen data from x,v to 
x •+* x s i z e ,. v ■+■ v s i z e . Stores t h e c a t a in the Duff sr 
s Dec i tied bv group , buffer . Once tne block is saved. 
vou can out it back in its original location or in 
another on the screen, using tne Put function. 

General! v., it is considered a good idea to use vour 
process id as the arouo number. It is also consiaerec 
a a o o d i d e a t o f i r s t K i 1 1 B u f f tne a r o u d w h e n v o u r 
program first starts lid. This requirement may 
d i s a d D9 a r s oo n . 

CAVEATS 

Get will De affected bv Scaiina.. If the Get/Put Duff or- 
is not alreadv defmea. Get creates it- If the buffer 
is defined- its size must be greater than or eaual to 
the desired new Get size. 

SEE ALSO 

Put 



GE T rAL.5 05K BGFX LiDrarv oi=.TPAL5 

FUNCTION 

'jstPais - Rsaa wmaow oaletts settings 
BGFX 

RUN bgf x ( [oath „ II "SetPals" « &rra.v . first, count ) 

PARAMETERS 

Dath = QDtionai oath to window 

B.rrav = Duttsr tor returned data 

first = first oalatter register to return 

count = numoer of registers to return 

DESCRIPTION 

SetPals returns the values for the numoer of oalette 
registers specified by count starting at the GLUT 
(Color Look Up Taole) offset passed in first ■ A copv 
o- tne color information is returned in the buffer 
pointed to bv a.rr.Bv , GetPals allows getting any or ail 
the oalette registers information at one time. 

CAVEATS 

Arrav sjhoujLd be large enough to hold 3 times the 
$ -- ire d eg unt .. T o r e s e r v e s p a c e f o r a II 256 d a 1 e 1 1 e s .. 
use something like: 

DIM palettes ( 768 ): BYTE 

G^unt is the number of triolets (R,G ? B bytes) to coov,, 
NOT the lenqth of the oaletts data in bvtes. 



FUNCTION 

GerPnt - Set cox or o*f oixei 
BGFX 

RUN bg + K ( Cpath , j "GetPnt" - >; , y , prn ; 

PARAMETERS 

oath = QS-9 path number tor the window 

x,y = window coordinate 

prn - return palette register number 

DESCRIPTION 

GetPnt returns tne color (or rather, the oaiette 

registe 

window n 

EXAMPLES 
CAVEATS 

SEE ALSO 

Color a P o i r 



di-'lUml 1 C-5 !: , BGr'X Library GPL GAD 

FUNCTION 

BPLoaa ™ Preload a Bet/Put Butter 
CODE 

IB 2B grp bfn stv XSiz xsiz Ysiz vsiz Len 1 en l„ »ciata,: „ I! 
BGFX 

RUN bgf x ( [path, J "SPLoad " -group ,bufter. type, xsize 5 ysize - lenqtr 
PUT #oath , dataarray 

PARAMETERS 

group = group number associated with the buffer 
butter = butter number 
tvoe = tvoe for tne ctata 

00 = non-gtx data (fonts, for example) 

01 ™: 2 bits /pixel 

2 = 4 bit s / d i x e 1 
0Z = S bits/nixe! 

;-(s::e = horizontal size tor the data 
ysize = vertical size for the data 
length - length of oata in bvtes 

DESCRIPTION 

GPLoad allocates ana prepares to load a Get /Put oufier 
witn aata„ After receiving a GPLoad ( ) call, the system 
j. oads the next avtss written to that oath into the 
specified get/ out ov.fi sr . 

CAVEATS 

If the Get/Put buffer is not already created. GPLoad 
creates it- If the Duffer was previously created » it 
i s d elet ed first. 

If vou accidentally specify a larger data length than 
vou have, a CTRL-C will abort the GPLoad. 

Note that the data tvpes a.r& different from screen 
types- This is a result of back compatibility with the 
very earliest Wind 10 versions- In the future, new 
calls will be added to fix this. 

SEE ALSO 

Get, Pu t , Font, K i 1 1 Bu f f 



ID 05K BGFX Li orarv III 

FUNCTION 

ID - .Returns process id 
BGFX 

RUN bgtxc "ID" „ id) 
PARAMETERS 

id - process xd returned in integer 

DESCRIPTION 

Instead at using svscali, ID can be used as a auick 
method ot aettina the orocess id tor use as the group 
number -for butters,, ere- 



KIlLBUFF OSK GFX Librarv KILLBUFF 

FUNCTION 

Kill butt - Deallocate a Get/Put Butter 
CODE 

IB 2A arc fatn 
BGFX 

RUN bgfx ( ['path, 3 i: Ki 1 IButt " „ gro, btn) 

PARAMETERS 

oath = ootional OS-9 oath numder tor the window 
grp = grouD number associated with the butter 

Dtn = butter number 

DESCRIPTION 

Deal locates tne soecified get/out butter.. To 
deallocate an entire group of buffers, set tne buffer 
numoer to 0„ 

CAVEATS 

host times,. a Droaram will use its own orocess id as 
the grouo number (this may be Gotten with the BGFX :i ID ;: 
command). It is also consiaereo oruaent to KillButt 
tnat group when your orogram begins, anci is considered 
oolite for vour oroaram to KillButt thB arouc on exit 
\ to save memory soacs, 1 - 



l. .1. N E Si \ E' r 3 F X LiDra r v L I N E 

FUNCTION 

Line? - Draw lines- 

CODE 

IB 44 X2 x2 Y2 v2 (Line) 

IB 45 Xo xo Yo vo ^RLine) 

IB 46 X2" x2 Y2 v2 (LineM) 

IB 47 Xd xo Yo vo (RLineM) 

BGFX 

RUN bg-f x < loath , j "Line 11 , xi« vi, x2, v2 ) 
RUN Dgtx ( [path . J "Line" B >c2, v2) 

PARAMETERS 

xi-vi = ODtional start move-to coordinate 
kv.v2 = end coordinate 

DESCRIPTION 

All the Line escape codes draw from the current 
drawDOinter position- The "R" versions use a relative 
offset to specific the end coordinate, and tne "M 11 
versions also update the draw pointer to the endpoint. 

Tne BGFX Line command uses absolute coordinates- A 
"DRAW" command which uses the relative version will be 
added to BGFX soon . 

SEE ALSO 

SetDPtr., RSetDctr 



l. u l~ J. U u b i- ; .. t^br X Liora r 

FUNCTION 

lcqic - Set drawing loaic moae 
CODE 

lb 2F mode 
BGFX 

RUN bar>M l oath ■ 3 "Logic", ''mode 11 ) 
MODES 

Code BGFX Description 



t !""! f-'j 'I' ! ' 



"off" no logic code, store new data on sc r st 
"ana" AND the new data with data on screen 
i; or n OR new data with the data on screen 
"xor" XOR new data with the data on screen 

Store all oat tern 

Brusn 



DESCRIPTION 



Logic de-fines the combinatorial moae to be used in all 
drawing commands on the window specified by path- 
Logic allows creating special affects . The specified 
mode will be used until another Loaic call cnanaes it* 



MOUSE QSk" B5FX Liprarv MOUSE 

FUNCTION 

Mouse - Get mouse status 
BGFX 

RUN DGtx ( "Mouse" ., val id , ar&s. , control „ w;< n ^v,Di , d2 ) 

PARAMETERS 

valid - validity -Flag; it" non-zero, window is selected 
area - window ar^a mouse is over 

- outside window 

1 = inside window, but outside working ar&a 

2 = inside current working area 
control - two byte id of anv hotsoot under cursor 
wk,wv - window relative/scaled coordinates 

bi - main button status (0 if up) 

b2 - secondary button status (not supported yet) 

DESCRIPTION 

Reads trie current mouse position and button status . and 
returns tnB snam mouse information reauired bv most 
oroarams „ 

The X ana V coordinates are scaled to the window. 

CAVEATS 

7ne first vaiu.B (valid flag) is important, as a zero 
value indicates that the other information should De 
ignored , 

SEE ALSO 

On House 



QNk'E'y 03k BSt X Librarv ONKEV 

FUNCTION 

unKev ~ Set: keyboard signal code 
BSFX 

RUN t>g + >i ( L path , 3 "OnKey" „ signal ) 
PARAMETERS 

signal = signal on key- If 00, sleep until key-- 

DESCRIPTION 

Calls SS JBSig to set up a signal code to be sent to 
vour program when a kev is hit. It a zero (OOj signal 
value is passed „ unKev will change it to a 1 (S^WaKe; 
arn.' go to SJ^p until woken cv a signal from the 
keyboard or other device. 

-■■ n R§J^ii#:3 Droarams, an ON ERROR statement mav De used 
to vector program flow on signals, 

CAVEATS 

This call is a one-snot signal- ana must ds reset eacn 
time. 

EXAMPLES 

RUN ho t ■■• ■- ' :1 on k- ev J « ,> \ '• % S I ee d un til mouse c 1 1 c k 

RuN Dotxi onksv' ,32-' it Si ana I 32 sent on ne 't click 

SEE ALSO 

Re lease- OnMouse 



UNliOUSE C£K B6FA Library ONMuUSc 

FUNCTION 

Onriouse - Set mouse signal cods 
BGFX 

RUN bqix i L oatn « J :i unMouss" .signal ) 
PARAMETERS 

signal = signal on cliak* li 00- slesD until click- 

DESCRIPTION 

Ca 'i : 3SJ v isSig to set up a signal code to be sent to 
vour program when the mouse button is Dressed. If a 
zero (00; signal value is passed,. GnMouse will change 
it to a 1 (3$wake) and go to Sleep until woken by a 
signal from the mouse or otner device.. 

i n Q^cK&a programs ? an UN ERROR statement mav oe usee! 
to vector program 'Uon on signals, 

CAVEATS 

time . 

EXAMPLES 

'--"UN DQtx\ !l onniQLtse" ,0.) \ \ '$■ bleeo until mouse cuck 

RUN bgf ;■• ( "onmouse 1 "' « 32) \ ( ■* Sianal 32 sent on next cIick 

SEE ALSO 

Release , OnKev 



OwSET 05K BGi-'X LiDrarv OwSET 

FUNCTION 

GwSet - Overlay window Set 
CODE 

IB 22 svx cox cov szx szv torn bprn 
B6FX 

.RUN dqtk ( Lpatn „ II "OWSet". svs, cdx , cov, szk, szv, torn, bprn 

PARAMETERS 

5V5 = save switch 

cpx = horizontal cnarsicter position for ine uooer 

left corner of the window 
cov = vertical position for the upper left corner 

of the window 
5z;-i - size (width) of the window in characters 
szy = size (height; of the window in characters 
f d rn " torea round pa 1 e t r e reg i s ter number 
horn = background calstte register number 

DESCRIPTION 

Creates an overlay window of size cdx.xdv on the 
current device window . 

If tne save switch ( svs ) is 0, the svstem Does not save 
the area under the overlay window. If k ~ v s -■ is i, the 
svstem saves the ares, under the window if oossioie and 
restores it when OWEnd is c&lisdi« 

SEE ALSO 

CWArsa* OWEnd 



OWLND ObK BbFx Licrarv QUIEND 

FUNCTION 

OWEnd - Overlay Window End 
CODE 

IB 23 
BBFX 

RUN bg+M ( loath* j "OwEnd" ) 

DESCRIPTION 

Deallocates the too overlay window- If you created the 
window with a save switch of i , the area under the 
screen is restored- 

SEE ALSO 

OWSet 



^ h u E 1" 7 E 05 i< B G F X L i b r a r v PALE 7 7 E 

FUNCTION 

"'alette - Change the color in a caletts register 
CODE 

IB 3i prn r&d grn blu 
BSFX 

RUN bg-f x ( ['path , J "Palette",, Dm. red, grn „ blu) 

PARAMETERS 

path = optional OS-9 path number for the window 
prn = palette register number to load (0-255) 
r&ci = r&\j v a 1 u e ( *~ 2 5 5 ) 
grn = green value (0-255) 
blu ~ blue value (0-255) 

DESCRIPTION 

Palette allows changina thB colors in tne oaistte 
register soeci-fied bv prn to contain the color r ed „ 
QJZD - fi-Ly » "^ e color value mav be anv value between 
ana 25j5» wnic.n gives more than 16. mi 1 I io n color 
com Pmations to choose -from. 

CAVEATS 

unlv palettes 0-15 may be changed on a 16-coior 
window . 

SEE ALSO 

Color,, Da f Col 



PATTERN QSK BSi- X Library PATTERN 

FUNCTION 

Pattern - Set Bet/Put buffer as Graphics pattern 
CODE 

iB 2E grp bf n 
BGFX 

RUN bqf x ( Cpatn „ J "Pattern", grp, bt'n) 

PARAMETERS 

g r p = q r o u P n u m b e r a s s c c i a ted w i 1 h the b u f f ' e r 
bfn ~ buffer numDer 

DESCRIPTION 

S e t s a G e t / P* u t B utfer. q r e v .1 o u s 1 v c d d isd from t h e 
screen with GetBlk or loaded with GPLoad as tne current 
working grannies pattern « This pattern will be used 
with anv crannies command isae Point * Line- Put, etc) 
until turnec off dv set tine to a crouo b.ho Duffer 
number of cero„ 

S e v e r a I f a n c v d a 1. 1 e r n s a r e s u d d I i e ri in the s t b d a t s 

+ 1 '( PC 



CAVEATS 



Tne nu + tar usee must match i r c o I o r tvoe u in addition * 
the X ^ice o " !- tne but^s^ must do o+ a oowe*" of two 
■/ ^ 3i 4,8, 1 £;. „ 311 , t £*4 ., ancl so tor*" n „ h n *" o f u 1 J sc r ^pn ^ 



SEE ALSO 



Ls Et« li K U o a o 



PC) I NT 05k 3Gi- X Librarv P0 I N'T 

FUNCTION 

Point- RPoint - Draw a Point 

CODE 

IB 42 X x Y v 
IB 43 Xo xo Vo yo 

BGFX 

RUN bgtK( Coath, ] "Point", >; , y) 
RUN bgfK(LDath,] "Point") 

PARAMETERS 

;. : ; i( v - ==: q O 71 1 O h a 1 fi'i O V e ~ T. O 3. b S O I U t £? COO!'" d i n 3. t S 

DESCRIPTION 

Point araws a Domt either at the draw scintsr s 

current ooritionr or at tne coordinates SDecified bv 

CAVEATS 

Point will update the draw nomter to x.v.- 
SEE ALSO 

;— . pi t- T'i P T f-"~ P' p f^ t* l" ) p' T Y~ 



PRHpSi^ j_;cj, : B3PX Library PRGPbUi 

FUNCTION 

F':™od5w - Set/ reset Drooortional cn&r&cz&r attribute 
CODE 

IB 3F switch < 00=o ft. 01=on) 

BGFX 

RUN batx C LDath „ II "ProoSw". i; on ; ') 
RUN bgf x ( [path „ I! "ProoSw", n off".-< 

DESCRIPTION 

FtodSw turns Drooortional text ouiout on or off. 

CAVEATS 

At tnis time- FtodSw does not a-ttBct normal text, 
nowever. turn ma it on is imoortant for best results 
w h e n u s i n q v e c t o r or A m i q a fonts. 

SEE ALSO 

T C h r S w ., B o 1 ci S w 



■~' { J : 05K BSr-X Library PUT 

FUNCTION 

Put — Put a Get/Put Butter to ih& screen 
CODE 

IB 2D grp bfn >:h ;■; 1 vh yl 
BGFX 

RUN bg-f k ( Tpath- J "Put", grp, bfn, ;■; , v ) 

PARAMETERS 

oath = optional GS-9 path number for the window 
grp = group number associated with the buffer 
bfn = ^/u.-f-fer number 

= horizontal (x) coordinate to put the upper- 
left hand corner of the buffer, 
v = vertical w* coorcmate to put the upper 
left nana corner of the buffer. 

DESCRIPTION 

Moves a Get/Put Buirer. previously copied from the 
screen with Get or loaded with GPLoad to an ares, of the 
screen. The dimensions of the buffer were saved in the 
Get/Put buffer when it was created,. windio uses these 
dime n s i o n s w hen r e s t o r i n a the b u f f e r > 

CAVEATS 

Get/Put buffers cannot be sc&i&d* The image will be 
c 1 ipped if it does not fit within the current working 

a r e a - 

SEE ALSO 

Get- GPLoad 



s-vdi-hrtbt. Ubi< Hbr X Library Kt.Lfc.ttbE 

FUNCTION 

Rei&3.Be - releases anv device signals 
BGFX 

RUN bg-f y, i C oath.. 2 "Release' 1 ) 

DESCRIPTION 

Calls SS„Relea to turn otf anv signals set- lid bv 
Onnouse or DnKev. You might use this call it vou don't 
with to be interrupted within parr of vour Drcqram. 

SEE ALSO 

OnKey. On! v !ouse 



REvERSfz. GSK BGFX Linrarv REVERSE 



FUNCTION 



CODE 



BGFX 



RevOn - turn reversed text on 
R e .■' ft — turn r&x/ers&O texi off 



IF 20 (on) 

IF 21 (off) 



RUN harxi iloatn „ j "Kevun") 
RUN bat>;([cath.] "RevOtf" 



DESCRIPTION 

CoCo coHiDatiDis codes tc turn r&verss-cnz<rzKc:x.&r / £ on or 

oft - 

In the reverse moc!e n tent is written in the nackci round 
color, witn bacKfill lit enabled Dv n on -transparency , ! 

SEE ALSO 

TChrSw.! BQidbN, Underline functions 



SBl-a U3K BbFX LiDrarv SBuX 

FUNCTION 

SBox - Draw a two color shadowea don 
CODE 

None:; BGFX internal iy aoes Color and Line calls 
BGFX 

KUN bqt;<([path, j "SBok" .color! * col or 2 ,, x 1 „ yl , x2 „ y2 ) 

PARAMETERS 

color! - too and le-Ft color 

c o I o r 2 — bottom s.nd r i q h t c o I o r 

;:. i „ v i — upper le-ft coordinates; 

>;2,v2 - lower right coordinates 

DESCRIPTION 

ijy~3.w a 3D— looking rectancis. For ENa/npIi?, it coipri is 
a linht rjrgy „ and color 2 n ^ b I a c k « tr, n e r? s u 1 'it i n c- D o ■■• 
K'x.1 J. aooear as a "Dutton" c-rotruding towards vou „ Tne 
same colors in reverse would look like a aeoressed 

CAVEATS 

! r : c u. rrsn t d s s i r e d *{■" o r e c r o u. n d c o 1 o r s h o u I d b e r e s e t 
atr.er usina this command- 



5CAl.E5^ OSk BGFX Liararv SCALESUj 

FUNCTION 

ScaieSw - Turn scs::na on or off* 
CODE 

J. B 35 swi Tic h ( 00— of f „ i — on ) 

BGFX 

RUN bgf ;< ( l path ,, J "ScaleSw" , "on") 
RUN bqf ;•: ( L oath , J :i Sca 1 e5w :j . "off") 

DESCRIPTION 

ScaleSw turns graDnics coordinate scaling on or off, 

SEE ALSO 

C i x i A r e a 



FUNCTION 

S e I set -*■ Sslsct i n t e r a c t i v e w i n g o w 
CODE 

iB 21 
BGFX 

RUN bar x ( l oath, J "Se lee t Ji ) 

DESCRIPTION 

Defines the window associated with tne s Dec i tied oath 
as the interactive (in out) device window tor t nat 
orocess « l-f the previous interactive window far ihat 
o r o q r a m w a s c u r r e n 1 1 v d i s p I a y e d , the d i s p I a y w 1 1 I 
c. h a n a e to t h e n e w J. v s elected w i n d o w „ 

Note that araohics and text output can continue to anv 

otnsr oa tn „ 



NOTES 



Thb disolav change will also not take place if tne 
d r e v i o u s d a t h is no I o n a e r v a 1 1 d ( o pen ) , T h i s a 1 1 o w s 
neat (ana common I v used) tricks when forcing otner 

To cnanae to the other window „ and then come back on 



1) Open „ dwset and select new window Datn, 

2) Fotk tne subprogram to tnat new patn. 

3) Wait tor subprogram to exit. 

4 ) R e s e I e c t o r i a i n a I w i n d o w ( d i s p 1 a v w i 1 1 1 1 i o ) - 

5) Close new window path. 



To change to the otner window, but leave it displayed: 

1) Open, dwset and select new window path- 

2) Fork the subprogram to that new path. 
3> Close new window oath 

4) Reseleet original window (disolav will not change.' 



b h. i D r t K 05 K' B b K X L. i d r a r v S E 7 D P 7 K 

FUNCTION 

SetDPtr, RSetDPtr - Set Draw Pointer Position 

BSFX 

RUN bq + x C Cpath, 3 "SetDPtr " - k ., v) 
RUN bgt k ( C path, .1 "RSetDPtr" ,xo,vo) 

PARAMETERS 

KhV = direct window coordinate addressing 

;< o ,vo = relati ve a ddressing (tr om last dptr ;■; „ v ) 

DESCRIPTION 

S e t D P t r positions t n e o r a w p o i n t e r a t oositio n x , ■••• / « i n 
relation to the upper le-ft corner at the working region 
of the window- RSetDPtr positions the draw pointer at 
o t tsst mo , vg ., -from t h e draw do i n t e r ' s c li r r e n t 
position „ 

SEE ALSO 

S c a I e S w ,. C U) A r s a 



S f h< G F X LiD^a '•" s 



SETPALS 



FUNCTION 

f ~ t p ?. I ~: - Set m u 1 1 i p I e palette v a I li e s 
BGFX 

RUN bqf x < [path, j "SetPals" , array,, tirst « count) 

PARAMETERS 

path = optional path to window 
array = buffer containing palette data 
first = first paietter register to set 
count ~ number of registers to set 

DESCRIPTION 



bet Pa Is 
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CAVEATS 



snoui ci De larcn 
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SLEEP ObK BGF'.K Librarv SLEEP 

FUNCTION 

Sleec - Put: calling process to sleep 
BGFX 

RUN bgf x ( "Sleep" - ticks ) 

PARAMETERS 

ticks - time in 1/iOOths of a second 
- or zero to sleep until signal 

DESCRIPTION 

This function calls F^SIeep. There are two main uses: 

First, in place of i: busv loops' 1 tor program delays such 
as causing between Puts during an animation.. 

Seconds when used witn a parameter ct zero a no in 
con i unction with OnKev and/or 0nr1ou.se signal calls- tne 
process can easily Ds suspended until the user hits a 
Key or mouse nutton. 

SEE ALSO 

OnKev , Onriouse 






ji*i- : . 5GKX LiDrarv 



CHR3W 



FUNCTION 



CODE 



BSFX 



nrSw - Set/rsset transparent character attriDute 



IB 3C switch (O0~off„ Oi=on) 



RUN aqixi Loath, 2 "TuhrSw". "on") 
RUN bat x ( [path, J "TChrSw" • "off") 



DESCRIPTION 



TLhrSw turns text transparence on or off for any 

f O 1 I O W X n O t B ':■'■. t Q LI t D U t. » 

i,-\t n en s e t t q ' ' on" » onlv the printaDle t s x t d i x s I s a r e 
sst in the current •fansgroLind color. ,, the emotv 
p i ; ■• & I s ar'8 left alone,, 

This is nandv tor printing I a Dels witnin graphic 
o r a w i n Q s « or for not a f f e c 1 1 n q d r e d r a w n b a c k' c r o u n d s - 



SEE ALbU 

SoIeiSw „ ProcSw 



JNDERL.INE 05k J&GKX Liorarv UNDERLINE 



FUNCTION 



CODE 



UndLnQn - turn text underlining an 
UndLnQff - turn text undsri inina off 



if ^ k on } 

IF 23 ( off ) 

BGFX 

RUN hafx ( Loath,, J "UndLnOn' 1 ) 
RUN bgTx( Cpath. j "undLnutt") 

DESCRIPTION 

CoCo comoatible codes to turn underlining on or off 

CAVEATS 

Backsoacing does not delete underline. 
SEE ALSO 

TChrSw. BoIdSw. Reverse functions 



WINFO OSK BGFX Library wINFQ 

FUNCTION 

wlnfo - bet information aoout window 
BGFX 

RUN bqf x ( Loath, 3 wtvoe, xsize , ysize , fore - sack , border ) 

PARAMETERS 

wtvoe = returned window tvpe 
xsize - returned size in pixels 
vsize = returned size in pixels 
fore = foregnd palette number 
back = backqnd palette number 
border = border palette number 

DESCRIPTION 

Wlnfo returns various information about the window 
associated with oath. 



